KCG Viral Tags

User Guide

KCG Viral Tags helps you build TikTok hashtags and YouTube tags for music and video content. Enter the core idea of the clip, choose a content focus, then use either quick generation or AI-assisted generation to produce export-ready tag blocks.

Getting Started

The main window is labeled Viral Tag Builder. The left side is where you describe the content. The right side is where the generated TikTok and YouTube results appear.

The program works best when your title, story, hook, and keywords describe one specific clip, song, release, or promotional moment. Broad or vague input usually produces weaker tags.

Quick build

Best when you want an immediate draft based only on the words you entered.

AI boost

Best when you want a stronger hook and more creative tag phrasing.

Quick Start

  1. Enter a value in Title.
  2. Choose a value in Content focus.
  3. Describe the clip in What makes this clip special?.
  4. Add supporting terms in Key words/phrases.
  5. Optionally fill in Genre(s), Mood / vibe, Audience / platform, and Call to action / offer.
  6. Leave or change the two checkboxes depending on the style you want.
  7. Click Quick build hashtags + tags or AI boost.
  8. Review the TikTok and YouTube text areas.
  9. Use the Copy buttons or Save To File.

Workspace Overview

The window is split into two practical areas:

  • Left panel: all source inputs used to build tags.
  • Right panel: the generated TikTok and YouTube output blocks.

A status line appears near the bottom of the window. It reports states such as ready, active content focus, AI progress, retry activity, and error messages.

The window does not resize. Plan to work inside the built-in layout instead of expecting panels to expand automatically.

Input Fields

Title

Use this for the song name, release title, clip title, or campaign label. A clear title gives the generator a central anchor.

What makes this clip special?

This is the main story field. Enter the strongest hook, story beat, lyric angle, or emotional payoff. The placeholder text is Hook, story, line....

Key words/phrases

Add the terms people might search for or react to. Separate ideas naturally with spaces, commas, or short phrases. The placeholder text is Enter keywords, key phrase, and/or key line....

Genre(s)

Use genres to strengthen niche targeting. Examples include pop, indie rock, synthwave, worship, folk, trap, or cinematic.

Mood / vibe

Describe the emotional tone. Examples include energetic, moody, romantic, reckless, cinematic, carefree, dark, or nostalgic.

Audience / platform

Describe the likely fan base, viewer type, or platform lane. Examples include new music fans, gym creators, heartbreak edits, worship community, indie music TikTok, or reaction channels.

Call to action / offer

Add phrases such as pre-save now, stream it, follow for part 2, share this with a friend, or comment your favorite line.

Style checkboxes

  • Include hook-style hashtags: asks the generator to use stronger hook energy inside the TikTok result.
  • Highlight fan communities / trends: pushes the generator toward community and trend-aware tags.

Content Focus Types

The Content focus popup controls the direction of the generated tags.

Music Track

Use for audio-first promotion, new songs, snippets, and streaming pushes.

Music Video

Use for official videos, visual clips, trailer edits, and cinematic promotions.

Other Video

Use for creator content that is not primarily a song release or music video.

The current focus also appears in the status line, which helps confirm the active lane before you generate anything.

Generation Modes

Quick build hashtags + tags

This button creates a fast draft from the words you already entered. It does not call the AI service. It is useful for rough ideas, speed, or fallback work.

  • TikTok output is built from extracted words plus boosted hashtags.
  • YouTube output is built from the entered phrases and type-specific ideas.
  • The quick mode does not enforce the AI validation retry loop.

AI boost

This button sends your content description to the configured Groq-backed AI service and asks for a stronger hook plus platform-specific tag lists.

  • The AI mode expects a valid API key.
  • The key can be loaded from the window settings or from a file named Groq Key.txt next to the application.
  • The AI response is validated before the program accepts it as final output.
If AI boost reports that the service cannot be reached, confirm the network access first.

AI Validation and Retries

When you press AI boost, the generated content is not accepted blindly. The program checks both output fields for the required structure and content rules.

Required output structure

Both output fields must contain:

  1. A valid hook on the first line.
  2. A blank line.
  3. The platform tags after the blank line.

TikTok validation rules

  • The hook must exist and must not be empty.
  • The tag line must contain 14 to 20 hashtags.
  • Each TikTok tag must begin with #.

YouTube validation rules

  • The same hook must appear above the blank line.
  • The tag line must contain 15 to 28 comma-separated tags.
  • YouTube tags must not contain the # symbol.

Retry behavior

If the AI response fails validation, the program automatically asks the AI to regenerate. It will retry up to 3 additional times. If all retries fail, the program stops and shows an error message instead of pretending the result is valid.

Understanding the Output Fields

TikTok hashtags - Choose less than 20

This field is formatted as a full TikTok block. The first part is the hook. After one blank line, the field contains the hashtag list.

YouTube comma tags - Choose 1 to 3 of them

This field is also formatted as a hook-first block. The first part is the same hook. After one blank line, the field contains comma-separated YouTube tags.

The labels say Choose less than 20 and Choose 1 to 3 of them, but the saved/generated output may contain a larger suggestion set so you can choose the strongest final tags manually.

Copy button

Copies the entire text area, including the hook, blank line, and tags.

Manual editing

You can edit the output blocks directly before copying or saving them.

Copying and Saving

Copy to clipboard

Each output area has its own Copy button. Use the TikTok copy button for the TikTok block and the YouTube copy button for the YouTube block.

Save To File

Click Save To File to export both generated blocks into a plain text file. The suggested filename is based on the title field.

The saved file includes:

  • The title at the top.
  • A TikTok section with the complete TikTok output block.
  • A YouTube section with the complete YouTube output block.

Best Results

Be concrete

Specific lyrics, visual moments, emotions, and audience details produce better tags than generic descriptions.

Use both story and keywords

The strongest results usually come from combining a clear story field with focused keyword phrases.

Set the right content focus

Music Track and Music Video produce different tag accents, so choose the lane deliberately.

Curate the final set

The generated output is a working set. Trim, reorder, or combine tags before posting if needed.

Troubleshooting

The AI result keeps failing validation

This usually means the service returned text that did not match the required structure. The program retries automatically. If all retries fail, try again with a clearer title, story, and keyword set.

The quick build output looks too generic

Add more specific keywords, genre details, and mood terms, or use AI boost for a more varied result.

The placeholders did not clear yet

Click into the description or keyword area and replace the placeholder text with your own content before generating.

The saved file name is not ideal

Enter the final content name in the Title field before saving. That value is used for the suggested filename.

KCG Viral Tags user documentation. Update this guide when the field layout, validation rules, AI workflow, or save format changes.